Get the department's limit on the cost of taxi trips

This request is used to get the department's limit on the cost of trips in a Taxi service.

Request syntax

GET https://b2b-api.go.yandex.ru/integration/2.0/departments/limits/taxi?department_id={department ID}

Request headers

• Authorization: Bearer <OAuth-token>
  OAuth access token. The steps to get a token are described in Getting started.

• X-YaTaxi-Selected-Corp-Client-Id — client ID from the account. Required if multiple clients are available using the token.

Request parameters

The request contains the following required parameter:

• department_id: department ID.

Response field description

Responses may contain the following fields:

Request example

GET https://b2b-api.go.yandex.ru/integration/2.0/departments/limits/taxi?department_id=87e823515f8a4f5a45dab0298c0f646c
...
Authorization: Bearer <OAuth-token>
X-YaTaxi-Selected-Corp-Client-Id: <client-id>

Response example

An example response to this request looks like this:

{
  "budget": 1000
}

Response codes

The response to this request may contain the following standard HTTP codes:

• 200: Request completed successfully.
• 400: An unknown parameter or a parameter with an invalid value was passed in the request.
• 401: The OAuth token is incorrect.
• 403:
  • SELECT_CLIENT_HEADER_REQUIRED: the request did not pass the header X-YaTaxi-Selected-Corp-Client-Id (returned if more than one client is available for the token).
  • SELECTED_CLIENT_ACCESS_DENIED: the header X-YaTaxi-Selected-Corp-Client-Id contains the client's ID, which this login does not have access to.
• 404: There is no department with the specified department_id.